home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Amiga Amateur Radio User Group / AARUG UK #81 (199x)(Amiga Amateur Radio User Group UK)(PD)[WB][G4DCV].zip / AARUG UK #81 (199x)(Amiga Amateur Radio User Group UK)(PD)[WB][G4DCV].adf / DisView / !ALIAS.TXT < prev    next >
Text File  |  1995-05-29  |  8KB  |  227 lines
  1. ==========                                          DISview [518]
  2. !ALIAS.TXT
  3. ==========
  4.  
  5. The DIS package supports two alias files:
  6.  
  7. 1. The alias file for incoming mail (~/alias). This  file is used
  8.    by your SMTP server.
  9.  
  10. 2. The alias file for outgoing mail (~/spool/mail/alias). This
  11.    file is used by PCElm and SNEWS.
  12.  
  13. The mailer in the built-in KA9Q BBS is unaware of either of these
  14. files.
  15.  
  16.  
  17.  
  18. ==================================
  19. INCOMING MAIL ALIAS FILE (~/alias)
  20. ==================================
  21.  
  22. To edit ~/alias from the DIS Session Manager:
  23. *****************************************************************
  24. MAIN MENU:D > CONFIGURE NET:D -- "Edit Incoming Mail ALIAS File"
  25. *****************************************************************
  26.  
  27.  
  28. >> Example of ~/alias:
  29. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  30. # ~/alias
  31.  
  32. default    deliver
  33. postmaster ian
  34.  
  35. ian.wade   ian
  36. ian-wade   ian
  37. root       ian
  38. inquiry    enquiry
  39. fred       forward fred@anyhost.com
  40.  
  41. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  42.  
  43. The incoming mail alias file (~/alias) is read by your SMTP 
  44. server. 
  45.  
  46. The incoming mail alias file is read _after_ the rewrite file
  47. (~/spool/rewrite).
  48.  
  49. Your SMTP server is unaware of the outgoing mail alias file
  50. (~/spool/mail/alias).
  51.  
  52. Fields in the alias file are separated by one or more spaces.
  53.  
  54. A new alias definition starts at the first character position on
  55. a line. Alias definitions may be longer than one line long -- 
  56. continuation lines start with one or more spaces.
  57.  
  58. The alias file may contain comment lines (starting with #) and/or
  59. blank (empty) lines to improve readability.
  60.  
  61. The alias name (the first field in an alias definition) may 
  62. contain dots or minus characters (but not "@" or "%"). 
  63.  
  64. Case does not matter; e.g. "postmaster" and "PostMaster" are the 
  65. same.
  66.  
  67. The second and subsequent fields of an alias definition contain 
  68. the alias expansion. The expansion may contain any mix of local 
  69. mailbox names and remote email addresses.
  70.  
  71. A local mailbox name must not exceed 8 characters, and must be a 
  72. DOS-compliant filename (without a dot or extension). The filename
  73. must not contain any of the following characters:
  74.  
  75.           \ " [ ] : | < > + = ; ,
  76.  
  77.  
  78. Incoming mail for a local mailbox is saved by default in the DOS
  79. file ~/spool/mail/<mailboxname>.txt.
  80.  
  81. Alias expansions in ~/alias cannot refer to other aliases (i.e. 
  82. it is not possible to build lists of lists).
  83.  
  84. Alias definitions in ~/alias are readable by remote users (with a 
  85. command like 'telnet <yournodename> 25', followed by the SMTP 
  86. 'EXPN' command). This may be a security issue.
  87.  
  88.  
  89.  
  90.  
  91. ============================
  92. "default" entries in ~/alias
  93. ============================
  94. The incoming mail alias file may contain a "default" entry. This
  95. entry must be the _first_ alias definition in the file.
  96.  
  97. The default entry may be either:
  98.       "default deliver" or 
  99.       "default <mailboxname>"
  100.  
  101.  
  102. "default deliver"
  103. -----------------
  104. The "default deliver" alias allows mail addressed to _any_ 
  105. mailbox on your system to be delivered without requiring 
  106. corresponding username entries in ~/ftpusers. 
  107.  
  108. Where an incoming username matches an alias, the mail is 
  109. delivered to the mailbox that corresponds to the alias. (In the
  110. above example, mail for "postmaster", "ian.wade", "ian-wade" and 
  111. "root" is all delivered to "ian", mail for "inquiry" is delivered
  112. to "enquiry", and mail for "fred" is delivered to "forward" and
  113. also forwarded to "fred@anyhost.com").
  114.  
  115. Where an incoming username does not match any alias, the mail is
  116. delivered to the <username> mailbox. Thus mail for "ianwade" is
  117. delivered to "ianwade", mail for "joebloggs" is delivered to
  118. "joeblogg", and so on.
  119.  
  120. The incoming mail alias file should have a "postmaster" entry. 
  121. Otherwise, mail addressed to "postmaster" will finish up in the 
  122. "postmast" mailbox (this is because mailbox names are restricted 
  123. by DOS to 8 characters). It is preferable to alias "postmaster" 
  124. to your main mailbox name, making it less likely that you will 
  125. miss seeing any "postmaster" mail.
  126.  
  127.  
  128. "default <mailboxname>"
  129. -----------------------
  130. If the incoming mail alias file contains the entry "default 
  131. <mailboxname>" (e.g. "default ian") instead of "default deliver",
  132. then all mail which does not match any other aliases in the file
  133. is delivered to <mailboxname>.
  134.  
  135. N.B. For this to work, you must also have an entry in ~/ftpusers
  136.      for <mailboxname> and for every other aliased mailbox. For
  137.      example, if ~/alias looks like this:
  138. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  139. # ~/alias
  140. default      ian
  141.  
  142. # Mailboxes for incoming mail from lists
  143. fire-digest  firewall
  144. solaris      sun
  145.  
  146. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  147.  
  148. then you must have a corresponding ~/ftpusers that looks 
  149. something like this:
  150. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  151. # ~/ftpusers
  152. ian ianspassword \DEMON 71
  153. firewall ~ \TEMP 0
  154. sun ~ \TEMP 0
  155.  
  156. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  157.  
  158. That is, there is a user entry in ~/ftpusers for every local 
  159. mailbox name in ~/alias.
  160.  
  161. The ~ passwords in ~/ftpusers signify that the "firewall" and 
  162. "sun" users can receive mail but cannot otherwise access your 
  163. system (e.g. via FTP or Telnet).
  164.  
  165. The main advantage of using "default <mailboxname>" instead of
  166. "default deliver" in ~/alias is that all mail goes to one mailbox
  167. (except any mail addressed to the aliases).
  168.  
  169.  
  170. No "default" entry
  171. ------------------
  172. If the "default deliver" entry is missing, any mail addressed to 
  173. your system will only be delivered to users having entries in 
  174. ~/ftpusers.
  175.  
  176. Mail addressed to other users not listed in ~/ftpusers will be 
  177. bounced (with one exception: any mail which is addressed to 
  178. "postmaster" will _always_ be delivered).
  179.  
  180.  
  181.  
  182.  
  183. =============================================
  184. OUTGOING MAIL ALIAS FILE (~/spool/mail/alias)
  185. =============================================
  186.  
  187. To edit ~/spool/mail/alias from the DIS Session Manager:
  188. *****************************************************************
  189. MAIN MENU:F > CONFIGURE MAIL:B -- "Edit ALIAS"
  190. *****************************************************************
  191.  
  192.  
  193. >> Example of ~/spool/mail/alias:
  194. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  195. # ~/spool/mail/alias
  196.  
  197. ian     ian@dowrmain.demon.co.uk
  198.  
  199. thegang alex@alpha.com    bill@beta.edu   george@gamma.org 
  200.         denise@delta.gov  outgoing
  201.  
  202. list1   thegang           oscar@omega.gov
  203.  
  204. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  205.  
  206. The outgoing mail alias file (~/spool/mail/alias) is read by 
  207. PCElm and SNEWS.
  208.  
  209. PCElm and SNEWS are unaware of the incoming mail alias file 
  210. (~/alias), the rewrite file (~/spool/rewrite) and ~/ftpusers.
  211.  
  212. Syntax rules for entries in ~/spool/mail/alias are the same as 
  213. for ~/alias.
  214.  
  215. In addition, for PCElm only, expansions in ~/spool/mail/alias 
  216. _can_ refer to other aliases (i.e. it is possible to build lists 
  217. of lists -- see the definition of "list1" in the example above).
  218. This does not apply to SNEWS.
  219.  
  220. N.B. Some versions of PCElm are broken, and do not process
  221.      the outgoing mail alias file properly. PCElm version 
  222.      1.11 fixes this problem and should be used in preference 
  223.      to earlier versions.
  224.  
  225. Alias definitions in ~/spool/mail/alias are _not_ accessible by 
  226. remote users.
  227.